Skip to main content

Receive Mock Funds

This operation simulates receiving funds through PIX payment to fill your Avenia balance with any currency.

Quote

Endpoint

GET /v2/account/quote/fixed-rate

Parameters

FieldValueTypeDescription
inputCurrencyBRLstringThe currency you are paying with
inputPaymentMethodPIXstringThe payment method you are using
outputCurrencyBRLAstringThe currency you want to receive
outputPaymentMethodINTERNALstringThe method you want to receive funds
inputAmount1000decimal.DecimalThe amount you want to pay/deposit. Required if outputAmount is not provided.
outputAmount-decimal.DecimalThe amount you want to receive. Required if inputAmount is not provided.
inputThirdPartyfalseboolSpecifies whether the input is coming from a third party. true or false.
outputThirdPartyfalseboolSpecifies whether the output is going to a third party. true or false.
blockchainSendMethodPERMITstringDefines the blockchain transaction type. Can be TRANSFER or PERMIT. Required for blockchain inputs.

Example

curl -X GET "https://api.sandbox.avenia.io:10952/v2/account/quote/fixed-rate?inputCurrency=BRL&inputPaymentMethod=PIX&inputAmount=1000&outputCurrency=BRLA&outputPaymentMethod=INTERNAL&inputThirdParty=false&outputThirdParty=false&blockchainSendMethod=PERMIT"
info

The outputCurrency and outputPaymentMethod can be any valid combination. See Supported Assets Table for valid options.

Ticket

To complete the operation, create a ticket with the quoteToken from the quote response:

{
"quoteToken": "eyJhdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"ticketBlockchainOutput": {
"beneficiaryWalletId": "00000000-0000-0000-0000-000000000000"
}
}
info

The nil UUID (00000000-0000-0000-0000-000000000000) represents the current operating account. If using a sub-account (with ?subAccountId={uuid} parameter), the operation will be performed for that sub-account. Without the sub-account parameter, it will be for the main account.

For different outputCurrency and outputPaymentMethod combinations, additional ticket parameters may be required. See Operations Combinations for details.